package org.ruoyi.interview.service;

import org.ruoyi.common.mybatis.core.page.PageQuery;
import org.ruoyi.common.mybatis.core.page.TableDataInfo;
import org.ruoyi.interview.domain.bo.InterviewQuestionBo;
import org.ruoyi.interview.domain.vo.InterviewQuestionVo;

import java.util.Collection;
import java.util.List;

/**
 * 面试题Service接口
 *
 * @author ruoyi
 */
public interface IInterviewQuestionService {

    /**
     * 查询面试题
     *
     * @param questionId 面试题主键
     * @return 面试题
     */
    InterviewQuestionVo selectInterviewQuestionById(Long questionId);

    /**
     * 查询面试题列表
     *
     * @param bo 面试题业务对象
     * @param pageQuery 分页对象
     * @return 面试题集合
     */
    TableDataInfo<InterviewQuestionVo> selectInterviewQuestionList(InterviewQuestionBo bo, PageQuery pageQuery);

    /**
     * 根据父级分类ID查询面试题列表（连表查询）
     *
     * @param bo 面试题业务对象
     * @param pageQuery 分页对象
     * @return 面试题集合
     */
    TableDataInfo<InterviewQuestionVo> selectInterviewQuestionListByParentId(InterviewQuestionBo bo, PageQuery pageQuery);

    /**
     * 查询面试题列表(带收藏状态)
     *
     * @param bo 面试题业务对象
     * @param pageQuery 分页对象
     * @param userId 用户ID
     * @return 面试题集合
     */
    TableDataInfo<InterviewQuestionVo> selectInterviewQuestionListWithFavorite(InterviewQuestionBo bo, PageQuery pageQuery, Long userId);

    /**
     * 查询面试题列表(带收藏状态和掌握状态)
     *
     * @param bo 面试题业务对象
     * @param pageQuery 分页对象
     * @param userId 用户ID
     * @return 面试题集合
     */
    TableDataInfo<InterviewQuestionVo> selectInterviewQuestionListWithStatus(InterviewQuestionBo bo, PageQuery pageQuery, Long userId);

    /**
     * 查询面试题列表
     *
     * @param bo 面试题业务对象
     * @return 面试题集合
     */
    List<InterviewQuestionVo> selectInterviewQuestionList(InterviewQuestionBo bo);

    /**
     * 新增面试题
     *
     * @param bo 面试题业务对象
     * @return 结果
     */
    Boolean insertInterviewQuestion(InterviewQuestionBo bo);

    /**
     * 修改面试题
     *
     * @param bo 面试题业务对象
     * @return 结果
     */
    Boolean updateInterviewQuestion(InterviewQuestionBo bo);

    /**
     * 修改面试题状态
     *
     * @param questionId 面试题主键
     * @param status 状态值
     * @return 结果
     */
    Boolean updateQuestionStatus(Long questionId, String status);

    /**
     * 批量删除面试题
     *
     * @param questionIds 需要删除的面试题主键集合
     * @return 结果
     */
    Boolean deleteInterviewQuestionByIds(Collection<Long> questionIds);

    /**
     * 查询用户收藏的面试题列表
     *
     * @param userId 用户ID
     * @param categoryId 分类ID
     * @param bo 面试题业务对象
     * @param pageQuery 分页对象
     * @return 面试题集合
     */
    TableDataInfo<InterviewQuestionVo> selectFavoriteQuestionList(Long userId, Long categoryId, InterviewQuestionBo bo, PageQuery pageQuery);

    /**
     * 批量新增面试题
     *
     * @param boList 面试题业务对象列表
     * @return 结果
     */
    Boolean insertInterviewQuestions(List<InterviewQuestionBo> boList);
}